-- Network Working Group D. Levi
-- Request for Comments: 2591 Nortel Networks
-- Category: Standards Track J. Schoenwaelder
-- TU Braunschweig
-- May 1999
--
--
-- Definitions of Managed Objects for
-- Scheduling Management OperationsDISMAN-SCHEDULE-MIB DEFINITIONS::=BEGINIMPORTSMODULE-IDENTITY,OBJECT-TYPE,NOTIFICATION-TYPE,
Integer32,Unsigned32,Counter32, mib-2
FROM SNMPv2-SMI
TEXTUAL-CONVENTION,DateAndTime,RowStatus,StorageType,VariablePointerFROM SNMPv2-TC
MODULE-COMPLIANCE,OBJECT-GROUP,NOTIFICATION-GROUPFROM SNMPv2-CONF
SnmpAdminStringFROM SNMP-FRAMEWORK-MIB;schedMIB MODULE-IDENTITYLAST-UPDATED"9811171800Z"ORGANIZATION"IETF Distributed Management Working Group"CONTACT-INFO"David B. Levi
Nortel Networks
4401 Great America Parkway
Santa Clara, CA 95052-8185
U.S.A.
Tel: +1 423 686 0432
E-mail: dlevi@nortelnetworks.com
Juergen Schoenwaelder
TU Braunschweig
Bueltenweg 74/75
38106 Braunschweig
Germany
Tel: +49 531 391-3283
E-mail: schoenw@ibr.cs.tu-bs.de"DESCRIPTION"This MIB module defines a MIB which provides mechanisms
to schedule SNMP set operations periodically or at
specific points in time."::={ mib-2 63}---- The various groups defined within this MIB definition:--schedObjects OBJECTIDENTIFIER::={ schedMIB 1}schedNotifications OBJECTIDENTIFIER::={ schedMIB 2}schedConformance OBJECTIDENTIFIER::={ schedMIB 3}
---- Textual Conventions:--SnmpPduErrorStatus::=TEXTUAL-CONVENTIONSTATUScurrentDESCRIPTION"This TC enumerates the SNMPv1 and SNMPv2 PDU error status
codes as defined in RFC 1157 and RFC 1905. It also adds a
pseudo error status code `noResponse' which indicates a
timeout condition."SYNTAXINTEGER{noResponse(-1),noError(0),tooBig(1),noSuchName(2),
badValue(3),readOnly(4),genErr(5),noAccess(6),wrongType(7),wrongLength(8),wrongEncoding(9),wrongValue(10),noCreation(11),inconsistentValue(12),resourceUnavailable(13),commitFailed(14),
undoFailed(15),authorizationError(16),notWritable(17),inconsistentName(18)}---- Some scalars which provide information about the local time-- zone.--schedLocalTime OBJECT-TYPESYNTAXDateAndTime(SIZE(11))MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The local time used by the scheduler. Schedules which
refer to calendar time will use the local time indicated
by this object. An implementation MUST return all 11 bytes
of the DateAndTime textual-convention so that a manager
may retrieve the offset from GMT time."::={ schedObjects 1}---- The schedule table which controls the scheduler.--schedTable OBJECT-TYPESYNTAXSEQUENCEOF SchedEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"This table defines scheduled actions triggered by
SNMP set operations."::={ schedObjects 2}schedEntry OBJECT-TYPESYNTAX SchedEntry
MAX-ACCESSnot-accessibleSTATUScurrent
DESCRIPTION"An entry describing a particular scheduled action."INDEX{ schedOwner, schedName }::={ schedTable 1}
SchedEntry ::=SEQUENCE{
schedOwner SnmpAdminString,
schedName SnmpAdminString,
schedDescr SnmpAdminString,
schedInterval Unsigned32,
schedWeekDay BITS,
schedMonth BITS,
schedDay BITS,
schedHour BITS,
schedMinute BITS,
schedContextName SnmpAdminString,
schedVariable VariablePointer,
schedValue Integer32,
schedType INTEGER,
schedAdminStatus INTEGER,
schedOperStatus INTEGER,
schedFailures Counter32,
schedLastFailure SnmpPduErrorStatus,
schedLastFailed DateAndTime,
schedStorageType StorageType,
schedRowStatus RowStatus}schedOwner OBJECT-TYPESYNTAXSnmpAdminString(SIZE(0..32))MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"The owner of this scheduling entry. The exact semantics of
this string are subject to the security policy defined by
the security administrator."::={ schedEntry 1}schedName OBJECT-TYPESYNTAXSnmpAdminString(SIZE(1..32))MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"The locally-unique, administratively assigned name for this
scheduling entry. This object allows a schedOwner to have
multiple entries in the schedTable."::={ schedEntry 2}schedDescr OBJECT-TYPESYNTAXSnmpAdminStringMAX-ACCESSread-createSTATUScurrent
DESCRIPTION"The human readable description of the purpose of this
scheduling entry."DEFVAL{ ''H }::={ schedEntry 3}schedInterval OBJECT-TYPESYNTAXUnsigned32UNITS"seconds"MAX-ACCESSread-createSTATUScurrentDESCRIPTION"The number of seconds between two action invocations of
a periodic scheduler. Implementations must guarantee
that action invocations will not occur before at least
schedInterval seconds have passed.
The scheduler must ignore all periodic schedules that
have a schedInterval value of 0. A periodic schedule
with a scheduling interval of 0 seconds will therefore
never invoke an action.
Implementations may be forced to delay invocations in the
face of local constraints. A scheduled management function
should therefore not rely on the accuracy provided by the
scheduler implementation."DEFVAL{0}::={ schedEntry 4}schedWeekDay OBJECT-TYPESYNTAXBITS{sunday(0),monday(1),tuesday(2),wednesday(3),thursday(4),friday(5),saturday(6)
}MAX-ACCESSread-createSTATUScurrentDESCRIPTION"The set of weekdays on which the scheduled action should
take place. Setting multiple bits will include several
weekdays in the set of possible weekdays for this schedule.
Setting all bits will cause the scheduler to ignore the
weekday."DEFVAL{{}}::={ schedEntry 5}schedMonth OBJECT-TYPESYNTAXBITS{january(0),february(1),march(2),april(3),
may(4),june(5),july(6),august(7),september(8),october(9),november(10),december(11)}MAX-ACCESSread-createSTATUScurrentDESCRIPTION"The set of months during which the scheduled action should
take place. Setting multiple bits will include several
months in the set of possible months for this schedule.
Setting all bits will cause the scheduler to ignore the
month."DEFVAL{{}}::={ schedEntry 6}schedDay OBJECT-TYPESYNTAXBITS{d1(0), d2(1), d3(2), d4(3), d5(4),d6(5), d7(6), d8(7), d9(8), d10(9),
d11(10), d12(11), d13(12), d14(13), d15(14),d16(15), d17(16), d18(17), d19(18), d20(19),d21(20), d22(21), d23(22), d24(23), d25(24),
d26(25), d27(26), d28(27), d29(28), d30(29),d31(30),r1(31), r2(32), r3(33), r4(34), r5(35),r6(36), r7(37), r8(38), r9(39), r10(40),
r11(41), r12(42), r13(43), r14(44), r15(45),r16(46), r17(47), r18(48), r19(49), r20(50),r21(51), r22(52), r23(53), r24(54), r25(55),r26(56), r27(57), r28(58), r29(59), r30(60),
r31(61)}MAX-ACCESSread-createSTATUScurrentDESCRIPTION"The set of days in a month on which a scheduled action
should take place. There are two sets of bits one can
use to define the day within a month:
Enumerations starting with the letter 'd' indicate a
day in a month relative to the first day of a month.
The first day of the month can therefore be specified
by setting the bit d1(0) and d31(30) means the last
day of a month with 31 days.
Enumerations starting with the letter 'r' indicate a
day in a month in reverse order, relative to the last
day of a month. The last day in the month can therefore
be specified by setting the bit r1(31) and r31(61) means
the first day of a month with 31 days.
Setting multiple bits will include several days in the set
of possible days for this schedule. Setting all bits will
cause the scheduler to ignore the day within a month.
Setting all bits starting with the letter 'd' or the
letter 'r' will also cause the scheduler to ignore the
day within a month."DEFVAL{{}}::={ schedEntry 7}schedHour OBJECT-TYPESYNTAXBITS{h0(0), h1(1), h2(2), h3(3), h4(4),h5(5), h6(6), h7(7), h8(8), h9(9),
h10(10), h11(11), h12(12), h13(13), h14(14),h15(15), h16(16), h17(17), h18(18), h19(19),h20(20), h21(21), h22(22), h23(23)
}MAX-ACCESSread-createSTATUScurrentDESCRIPTION"The set of hours within a day during which the scheduled
action should take place."DEFVAL{{}}::={ schedEntry 8}schedMinute OBJECT-TYPESYNTAXBITS{m0(0), m1(1), m2(2), m3(3), m4(4),
m5(5), m6(6), m7(7), m8(8), m9(9),m10(10), m11(11), m12(12), m13(13), m14(14),m15(15), m16(16), m17(17), m18(18), m19(19),m20(20), m21(21), m22(22), m23(23), m24(24),
m25(25), m26(26), m27(27), m28(28), m29(29),m30(30), m31(31), m32(32), m33(33), m34(34),m35(35), m36(36), m37(37), m38(38), m39(39),
m40(40), m41(41), m42(42), m43(43), m44(44),m45(45), m46(46), m47(47), m48(48), m49(49),m50(50), m51(51), m52(52), m53(53), m54(54),
m55(55), m56(56), m57(57), m58(58), m59(59)}MAX-ACCESSread-createSTATUScurrentDESCRIPTION"The set of minutes within an hour when the scheduled action
should take place."DEFVAL{{}}::={ schedEntry 9}schedContextName OBJECT-TYPESYNTAXSnmpAdminString(SIZE(0..32))
MAX-ACCESSread-createSTATUScurrentDESCRIPTION"The context which contains the local MIB variable pointed
to by schedVariable."::={ schedEntry 10}schedVariable OBJECT-TYPESYNTAXVariablePointerMAX-ACCESSread-createSTATUScurrentDESCRIPTION"An object identifier pointing to a local MIB variable
which resolves to an ASN.1 primitive type of INTEGER."::={ schedEntry 11}schedValue OBJECT-TYPESYNTAXInteger32
MAX-ACCESSread-createSTATUScurrentDESCRIPTION"The value which is written to the MIB object pointed to by
schedVariable when the scheduler invokes an action. The
implementation shall enforce the use of access control
rules when performing the set operation on schedVariable.
This is accomplished by calling the isAccessAllowed abstract
service interface as defined in RFC 2271."::={ schedEntry 12}schedType OBJECT-TYPESYNTAXINTEGER{periodic(1),calendar(2),oneshot(3)}MAX-ACCESSread-create
STATUScurrentDESCRIPTION"The type of this schedule. The value periodic(1) indicates
that this entry specifies a periodic schedule. A periodic
schedule is defined by the value of schedInterval. The
values of schedWeekDay, schedMonth, schedDay, schedHour
and schedMinute are ignored.
The value calendar(2) indicates that this entry describes a
calendar schedule. A calendar schedule is defined by the
values of schedWeekDay, schedMonth, schedDay, schedHour and
schedMinute. The value of schedInterval is ignored. A
calendar schedule will trigger on all local times that
satisfy the bits set in schedWeekDay, schedMonth, schedDay,
schedHour and schedMinute.
The value oneshot(3) indicates that this entry describes a
one-shot schedule. A one-shot schedule is similar to a
calendar schedule with the additional feature that it
disables itself by changing in the `finished'
schedOperStatus once the schedule triggers an action.
Changing a schedule's type is equivalent to deleting the
old-type schedule and creating a new-type one."
DEFVAL{ periodic }::={ schedEntry 13}schedAdminStatus OBJECT-TYPESYNTAXINTEGER{enabled(1),disabled(2)}MAX-ACCESSread-createSTATUScurrentDESCRIPTION"The desired state of the schedule."DEFVAL{ disabled }::={ schedEntry 14}schedOperStatus OBJECT-TYPESYNTAXINTEGER{
enabled(1),disabled(2),finished(3)}MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The current operational state of this schedule. The state
enabled(1) indicates this entry is active and that the
scheduler will invoke actions at appropriate times. The
disabled(2) state indicates that this entry is currently
inactive and ignored by the scheduler. The finished(3)
state indicates that the schedule has ended. Schedules
in the finished(3) state are ignored by the scheduler.
A one-shot schedule enters the finished(3) state when it
deactivates itself."::={ schedEntry 15}schedFailures OBJECT-TYPE
SYNTAXCounter32MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"This variable counts the number of failures while invoking
the scheduled action."::={ schedEntry 16}schedLastFailure OBJECT-TYPESYNTAXSnmpPduErrorStatusMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The most recent error that occured during the invocation of
a scheduled action. The value noError(0) is returned
if no errors have occurred yet."DEFVAL{ noError }::={ schedEntry 17}schedLastFailed OBJECT-TYPE
SYNTAXDateAndTimeMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The date and time when the most recent failure occured. The
value '0000000000000000'H is returned if no failure occured
since the last re-initialization of the scheduler."DEFVAL{ '0000000000000000'H }::={ schedEntry 18}schedStorageType OBJECT-TYPESYNTAXStorageTypeMAX-ACCESSread-createSTATUScurrentDESCRIPTION"This object defines whether this scheduled action is kept
in volatile storage and lost upon reboot or if this row is
backed up by non-volatile or permanent storage.
Conceptual rows having the value `permanent' must allow
write access to the columnar objects schedDescr,
schedInterval, schedContextName, schedVariable, schedValue,
and schedAdminStatus. If an implementation supports the
schedCalendarGroup, write access must be also allowed to
the columnar objects schedWeekDay, schedMonth, schedDay,
schedHour, schedMinute."DEFVAL{ volatile }::={ schedEntry 19}schedRowStatus OBJECT-TYPESYNTAXRowStatusMAX-ACCESSread-createSTATUScurrentDESCRIPTION"The status of this scheduled action. A control that allows
entries to be added and removed from this table.
The miminum number of objects that need to be set during
row creation before a row can be set to `active' are
schedContextName, schedVariable and schedValue."::={ schedEntry 20}
---- Notifications that are emitted to indicate failures. The-- definition of schedTraps makes notification registrations-- reversible (see STD 58, RFC 2578).--schedTraps OBJECTIDENTIFIER::={ schedNotifications 0}schedActionFailure NOTIFICATION-TYPEOBJECTS{ schedLastFailure, schedLastFailed }STATUScurrentDESCRIPTION"This notification is generated whenever the invocation of a
scheduled action fails."::={ schedTraps 1}-- conformance informationschedCompliances OBJECTIDENTIFIER::={ schedConformance 1}
schedGroups OBJECTIDENTIFIER::={ schedConformance 2}-- compliance statementsschedCompliance MODULE-COMPLIANCESTATUScurrentDESCRIPTION"The compliance statement for SNMP entities which implement
the scheduling MIB."MODULE-- this moduleMANDATORY-GROUPS{
schedGroup, schedNotificationsGroup
}GROUP schedCalendarGroup
DESCRIPTION"The schedCalendarGroup is mandatory only for those
implementations that support calendar based schedules."OBJECT schedType
DESCRIPTION"The values calendar(2) or oneshot(3) are not valid for
implementations that do not implement the
schedCalendarGroup. Such an implementation must return
inconsistentValue error responses for attempts to set
schedAdminStatus to calendar(2) or oneshot(3)."::={ schedCompliances 1}schedGroup OBJECT-GROUPOBJECTS{
schedDescr,
schedInterval,
schedContextName,
schedVariable,
schedValue,
schedType,
schedAdminStatus,
schedOperStatus,
schedFailures,
schedLastFailure,
schedLastFailed,
schedStorageType,
schedRowStatus
}STATUScurrentDESCRIPTION"A collection of objects providing scheduling capabilities."
::={ schedGroups 1}schedCalendarGroup OBJECT-GROUPOBJECTS{
schedLocalTime,
schedWeekDay,
schedMonth,
schedDay,
schedHour,
schedMinute
}STATUScurrentDESCRIPTION"A collection of objects providing calendar based schedules."::={ schedGroups 2}schedNotificationsGroup NOTIFICATION-GROUPNOTIFICATIONS{
schedActionFailure
}STATUScurrentDESCRIPTION"The notifications emitted by the scheduler."::={ schedGroups 3}
END